Upgrade Fabric using Interactive Mode

You can upgrade a single-node XCO using interactive mode.

About this task

Follow this procedure to upgrade a single-node XCO on Server.

Procedure

  1. Download the XCO tar file and the digests file to the Linux server. Use an administrative account to install XCO on this server.
    admin@server$ ls
    efa-3.4.0-digests.tar.gz  efa-3.4.0.tar.gz
  2. Verify the PGP signature as described in article 48172 on the Extreme Portal.
  3. Extract the XCO tarball to a desired location. Ensure that this location has the permissions to allow your administrative user to run commands.
  4. Change the current directory to the extracted file location, and run the source deployment.sh --deploy-suite fabric command. This will start the XCO installation in a menu-driven interactive mode.
  5. When prompted, select Upgrade, Single-node deployment, or Fabric Automation.
    Tip

    Tip

    Use arrow keys to move between options. Press the space bar to select an option.
    admin@server:~/efa$ source deployment.sh -g no 
    Step 1: Checking for EFA Stack... 
    Previous Stack found
    Please choose: 
    1 Remove the current EFA Stack
    2 Upgrade/Re-deploy 
    2 Please choose: 
    1 Single-node deployment 2 Multi-node deployment 1 Single-node Deployment
  6. When prompted, select the IP mode (IPv4 single stack, or Dual ip-stack). Then select OK.
    Tip

    Tip

    • Use arrow keys to move between options. Press the space bar to select an option.
    • Depending on the IP stack selection, system will prompt you with appropriate IP address input.
  7. When prompted to configure additional management IP networks, take one of the following steps:
    • Select No to ignore this optional step or when you have finished entering sub-interface information.
    • Select Yes and then provide the requested information
      • Sub-interface name, which is a unique name that contains no more than 11 characters, no white space, and no % or / characters.
      • ID of the VLAN that the management network uses to tag traffic. Valid values range from 2 through 4093.
      • IP subnet address in CIDR format. The subnet must not overlap with any IP subnet that you have already provided.
      • An IPv6 address is optional, but an IPv4 address is mandatory.

    As the installation proceeds, messages display showing the installation progress.

  8. Verify the installation.
    • From the EFA command line on the console or SSH session, run the sudo efactl status command to see the status of nodes, pods, and services.
    • Run the efa status command to ensure that all nodes are up.
    admin@server$ sudo efactl status
    Node: efa
    NAME                               READY   STATUS    RESTARTS   AGE   IP             NODE   NOMINATED NODE   READINESS GATES
    pod/efa-api-docs-sbg9x             1/1     Running   0          12m   10.42.194.71   efa    <none>           <none>
    pod/gosystem-service-m7245         1/1     Running   0          12m   10.42.194.74   efa    <none>           <none>
    pod/rabbitmq-cf57z                 1/1     Running   0          13m   10.42.194.68   efa    <none>           <none>
    pod/gonotification-service-5nhqb   1/1     Running   0          11m   10.20.229.54   efa    <none>           <none>
    pod/goinventory-service-m8fgm      1/1     Running   0          12m   10.42.194.69   efa    <none>           <none>
    pod/goauth-service-qr7zs           1/1     Running   0          12m   10.42.194.70   efa    <none>           <none>
    pod/gofaultmanager-service-gszrm   1/1     Running   0          12m   10.42.194.72   efa    <none>           <none>
    pod/gofabric-service-wrl6z         1/1     Running   0          12m   10.42.194.76   efa    <none>           <none>
    pod/gopolicy-service-4llmn         1/1     Running   0          12m   10.42.194.75   efa    <none>           <none>
    pod/goraslog-service-2w8hj         1/1     Running   0          12m   10.20.229.54   efa    <none>           <none>
    pod/gotenant-service-zhbp2         1/1     Running   0          12m   10.42.194.77   efa    <none>           <none>
    pod/gosnmp-service-5jnqv           1/1     Running   0          11m   10.20.229.54   efa    <none>           <none>
    pod/gorbac-service-jnttb           1/1     Running   0          12m   10.42.194.73   efa    <none>           <none>
    
    NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                          AGE   SELECTOR
    service/rabbitmq                 ClusterIP   10.43.219.62    <none>        15672/TCP,5672/TCP               13m   app=rabbitmq
    service/rabbitmq-local           NodePort    10.43.200.66    <none>        15672:30673/TCP,5672:30672/TCP   13m   app=rabbitmq
    service/goinventory-service      ClusterIP   10.43.96.100    <none>        8082/TCP                         12m   app=goinventory-service
    service/efa-api-docs             ClusterIP   10.43.127.190   <none>        80/TCP                           12m   app=efa-api-docs
    service/goraslog-service         ClusterIP   10.43.19.118    <none>        8091/TCP                         12m   app=goraslog-service
    service/gonotification-service   ClusterIP   10.43.11.74     <none>        8088/TCP                         12m   app=gonotification-service
    service/goauth-service           ClusterIP   10.43.133.78    <none>        8080/TCP                         12m   app=goauth-service
    service/gorbac-service           ClusterIP   10.43.228.98    <none>        8089/TCP                         12m   app=gorbac-service
    service/gofaultmanager-service   ClusterIP   10.43.58.187    <none>        8094/TCP                         12m   app=gofaultmanager-service
    service/gosystem-service         ClusterIP   10.43.141.200   <none>        8090/TCP                         12m   app=gosystem-service
    service/gofabric-service         ClusterIP   10.43.245.50    <none>        8081/TCP                         12m   app=gofabric-service
    service/gopolicy-service         ClusterIP   10.43.36.27     <none>        8093/TCP                         12m   app=gopolicy-service
    service/gotenant-service         ClusterIP   10.43.52.211    <none>        8083/TCP                         12m   app=gotenant-service
    service/goopenstack-service      ClusterIP   10.43.26.123    <none>        8085/TCP                         12m   app=goopenstack-service
    service/govcenter-service        ClusterIP   10.43.21.5      <none>        8086/TCP                         12m   app=govcenter-service
    service/gohyperv-service         ClusterIP   10.43.43.180    <none>        8087/TCP                         12m   app=gohyperv-service
    service/gosnmp-service           ClusterIP   10.43.78.109    <none>        8092/TCP                         12m   app=gosnmp-service
    
    NAME                                    DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR       AGE   CONTAINERS               IMAGES                 SELECTOR
    daemonset.apps/goopenstack-service      0         0         0       0            0           non-existing=true   12m   openstack                goopenstack:3.4.0      app=goopenstack-service
    daemonset.apps/efa-api-docs             1         1         1       1            1           <none>              12m   efa-api-docs             efa-api-docs:3.4.0     app=efa-api-docs
    daemonset.apps/govcenter-service        0         0         0       0            0           non-existing=true   12m   vcenter                  govcenter:3.4.0        app=govcenter-service
    daemonset.apps/gohyperv-service         0         0         0       0            0           non-existing=true   12m   hyperv                   gohyperv:3.4.0         app=gohyperv-service
    daemonset.apps/gosystem-service         1         1         1       1            1           <none>              12m   gosystem                 gosystem:3.4.0         app=gosystem-service
    daemonset.apps/rabbitmq                 1         1         1       1            1           <none>              13m   rabbitmq-node            rabbitmq:3.4.0         app=rabbitmq
    daemonset.apps/gonotification-service   1         1         1       1            1           <none>              12m   gonotification-service   gonotification:3.4.0   app=gonotification-service
    daemonset.apps/goinventory-service      1         1         1       1            1           <none>              12m   goinventory-service      goinventory:3.4.0      app=goinventory-service
    daemonset.apps/goauth-service           1         1         1       1            1           <none>              12m   go-auth                  goauth:3.4.0           app=goauth-service
    daemonset.apps/gofaultmanager-service   1         1         1       1            1           <none>              12m   gofaultmanager-service   gofaultmanager:3.4.0   app=gofaultmanager-service
    daemonset.apps/gofabric-service         1         1         1       1            1           <none>              12m   gofabric-service         gofabric:3.4.0         app=gofabric-service
    daemonset.apps/gopolicy-service         1         1         1       1            1           <none>              12m   gopolicy-service         gopolicy:3.4.0         app=gopolicy-service
    daemonset.apps/goraslog-service         1         1         1       1            1           <none>              12m   goraslog-service         goraslog:3.4.0         app=goraslog-service
    daemonset.apps/gotenant-service         1         1         1       1            1           <none>              12m   gotenant-service         gotenant:3.4.0         app=gotenant-service
    daemonset.apps/gosnmp-service           1         1         1       1            1           <none>              12m   gosnmp-service           gosnmp:3.4.0           app=gosnmp-service
    daemonset.apps/gorbac-service           1         1         1       1            1           <none>              12m   go-rbac                  gorbac:3.4.0           app=gorbac-service
    admin@server:~$ efa login
    Password:
    Login successful.
    --- Time Elapsed: 4.121103171s ---
    (efa:admin)admin@server:~$ efa status
    +-----------------+--------+--------+--------------+
    | Node Name       | Role   | Status | IP           |
    +-----------------+--------+--------+--------------+
    | server          | active | up     | 10.20.229.54 |
    +-----------------+--------+--------+--------------+
    --- Time Elapsed: 4.656427295s ---